home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / archive / stlth30.arj / STEALTH.DOC < prev    next >
Text File  |  1994-01-07  |  20KB  |  624 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               ██▀▀▀▀
  9.               ██▄▄▄▄ ▀▀██▀▀ ██▀▀▀  ██▀▀█  ██  ▀▀██▀▀ ██  █
  10.                    █   ██   ██▀▀   ██▀▀█  ██    ██   ██▀▀█
  11.               ▄▄▄▄▄█   ██   ██▄▄▄  ██  █  ██▄▄  ██   ██  █
  12.              3.0  (c) 1994 David Smith  All rights reserved
  13.  
  14.  
  15.  
  16.  
  17.               --==≡≡ THE Archive Converter for 1994 ≡≡==--
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. ==========  QUICK START !  ==================================================
  29.  
  30.  
  31.         Put STEALTH.EXE in a "test" directory containing some archives.
  32.  
  33.         Make sure STEALTH.EXE is in your "PATH=" statement.
  34.  
  35.         Type: STEALTH.EXE
  36.  
  37.         Now watch as all the archives are converted to your favorite
  38.         compressor!  This program finds them all: PAK ZIP HAP SQZ LZH
  39.         plus tons more, then converts them to your 'favorite' archiver.
  40.  
  41.         Now type: CD\
  42.  
  43.         Notice that STEALTH.LOG has been written there.  Use EDIT.COM
  44.         from DOS 5+ and look at it.  Just type: EDIT STEALTH.LOG
  45.  
  46.         All action from Stealth has been written, including dates, times
  47.         and DOS commands that it used.
  48.  
  49.               Type: STEALTH /?   for a quick help screen!
  50.  
  51.  
  52.  
  53. =============================================================================
  54.  
  55.  
  56.  
  57.         Advanced users:  Welcome to the world of Stealth.  This program
  58.         is quite unique, because it will convert ANY archive to ANY
  59.         other archive.  The advantages of this over other competition
  60.         programs (like ZZAP, SHEZ, etc...) is:
  61.  
  62.         ■   It supports every major archiver available!  ARJ, ARC, LHA,
  63.             HAP, SQZ, DWC, PAK, ZIP 1.1 and 2.0, ICE, LHARC, LARC, UC2,
  64.             HYPER, SDN, FCOMPACT, and ZOO.
  65.  
  66.         ■   It can recognize PKZIP 1.1 files and PKZIP 2.0 "normal"
  67.             compressed files, then convert them to PKZIP -EX "extra"
  68.             compression.  This will save you a ton of hard disk
  69.             space!
  70.             NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  71.                   format.  Therefore, all 2.0 "stored" archives are
  72.                   flagged as version 1.1.
  73.  
  74.         ■   Leave PKZIP -AV files alone, plus virus scanning using any
  75.             of the three most popular scanners!
  76.  
  77.         ■   Recognizes embedded directories, and can include them with
  78.             the conversion.
  79.  
  80.         ■   Is perfect for SYSOPS, since it can be run as an "event" to
  81.             update all .ZIP files, or be used as an upload processor.
  82.             Even add comments or strip them from the files...
  83.  
  84.         ■   You can "customize" STEALTH to almost any configuration.
  85.             Include some archives, but not others, recurse subdirectories,
  86.             leave SFX files alone, delete files after processing,
  87.             plus MORE.
  88.  
  89.         ■   Keeps an accurate log of all activity.
  90.  
  91.         ■   Lists archived files (registered version) using its own
  92.             'internal' compression viewer (super-fast!).
  93.  
  94.         ■   Allows overriding Stealth.cfg options on the command-line.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.         No other utility can do this!  Plus STEALTH recognizes even
  101.         DWC, SQZ, and LARC self-extracting files.  Please notice
  102.         that NO OTHER ARCHIVE program can do that.
  103.  
  104.         Is hard disk space important?  That PKZIP file you downloaded
  105.         yesterday... it is probably in 1.1 format.  In fact, most of
  106.         your PKZIP'ed files are 1.1 or else 2.0 "normal" compressed.
  107.  
  108.         Use STEALTH to maximize their compression.  You can save 60,000
  109.         bytes of disk space on a few files, and several megabytes if
  110.         you re-archive every downloaded file.  Doing that manually will
  111.         take FOREVER.  And even batch files are no good, since they are
  112.         so slow.  But, you can be assured of accuracy and speed with STEALTH!
  113.  
  114.  
  115.  
  116.                  STEALTH is extrememly simple:
  117.  
  118.         1. Edit STEALTH.CFG to your satisfaction (see below for details)
  119.            (or just use STL_CFG.EXE to create your OWN stealth.cfg)
  120.  
  121.         2. Include STEALTH.EXE and STEALTH.CFG in your path
  122.  
  123.         3. Go to a directory containing some old archives.
  124.  
  125.         4. Type: STEALTH.EXE    (or  STEALTH *.*)
  126.  
  127.  
  128.         Now note that Stealth processes the entire directory!  The
  129.         only filespec you need (optional) is *.*.  Stealth ruthlessly
  130.         converts everything it can find using your .CFG file.
  131.  
  132.         NOTE: You can use STEALTH *.*  or  STEALTH *.ZIP  .....
  133.  
  134.         And wala, you are all done.
  135.  
  136.         If you change your mind on archives, or want to change something,
  137.         STEALTH.CFG is easy to edit.
  138.  
  139.         Take your favorite editor and change it around.
  140.         NOTE:  If Stealth cannot locate STEALTH.CFG file, it will use
  141.                its own defaults.
  142.  
  143.  
  144.  
  145. z  =======================================================================
  146.  
  147.         NEW!  Stealth now has a variety of command line options
  148.               that will override the Stealth.cfg defaults.
  149.  
  150.         USAGE:    STEALTH [filespec] [options]
  151.  
  152.   Options:  /X        Give exact details in log file
  153.             /NOLOG    Don't use log
  154.             /VIRUS    Virus check archives
  155.             /SAVE     Save original files (don't delete)
  156.             /+        Debug STEALTH process (messy output, but detailed!)
  157.             /CMT      Add Comment file specified in STEALTH.CFG
  158.  
  159.  
  160.         /X      will provide a little more detailed information in STEALTH.LOG
  161.  
  162.         /NOLOG  will turn off STEALTH's log feature and not write anything
  163.                 to STEALTH.LOG
  164.  
  165.         /VIRUS  will activate virus scanning, even if you have that option
  166.                 turned off in STEALTH.CFG.  Make sure you have chosen a
  167.                 virus scanner in the configuration file!
  168.  
  169.         /+      will show a large amount of messy information on the screen,
  170.                 detailing exactly how STEALTH is thinking, and what part of
  171.                 the program it is in.  That way, you can debug where a problem
  172.                 is in case of a serious crash or lockup.
  173.  
  174.         /CMT    turns on the "add comment" feature.  Make sure you have
  175.                 included a comment file in STEALTH.CFG
  176.  
  177.  
  178.  
  179.  
  180.  
  181.         EXAMPLES:       STEALTH  *.ZIP /X
  182.                         STEALTH  *.*   /+/NOLOG
  183.                         STEALTH  *.ARJ /VIRUS/NOLOG/X
  184.  
  185.  
  186.  
  187.  
  188.  
  189.         Do not separate the options.  If you have more than one, place
  190.         them all together as shown above.
  191.  
  192.                 CORRECT:   STEALTH *.ZIP /X/NOLOG
  193.  
  194.               INCORRECT:   STELATH *.ZIP /X /NOLOG
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.              NOTE:    Any options specified on the command line will
  202.                       override the STEALTH.CFG settings!
  203.  
  204.  
  205.  
  206.  
  207.   ========================================================================
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.     IMPORTANT NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  219.                     format.  Therefore, all 2.0 "stored" archives are
  220.                     flagged as version 1.1.
  221.  
  222.  
  223.  
  224.  
  225.  
  226. ========= USING STEALTH.CFG FILE ============================================
  227.  
  228.         Included here is STEALTH.CFG, a configuration file for this program.
  229.  
  230.         Use the enclosed STL_CFG.EXE program for a quick and easy way
  231.         to create Stealth.cfg.  Just fill in the blanks, and change
  232.         the values to what you like best.
  233.  
  234.         Press [F10] to save Stealth.cfg and exit.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.         Now you can change it by using a text editor, and type out
  241.         which options you want to use.  The format is:
  242.  
  243.    ---------------------------------------------------------------------
  244.         Put the archiver you want everything converted to.
  245.  
  246.         [archiver]  =  archiver
  247.  
  248.         Whereas archiver could be:
  249.             PKZIP1     ARJ    LHA    DWC
  250.             PKZIP2     PAK    ZOO    ARC6
  251.             SQUEEZE    ICE    HAP    LARC
  252.             HYPER      FCOMPACT      LHARC   UC2
  253.    ---------------------------------------------------------------------
  254.         Next, put all the archives you want converted to YOUR archiver.
  255.         For instance, if you put LHA here, all .LZH files will be
  256.         converted.
  257.  
  258.         [archiver]  =  convert
  259.  
  260.         Whereas archiver could be:
  261.             PKZIP1     ARJ    LHA    DWC
  262.             PKZIP2     PAK    ZOO    ARC6
  263.             SQUEEZE    ICE    HAP    LARC
  264.             HYPER      UC2           LHARC
  265.    ---------------------------------------------------------------------
  266.         Now, do you want to strip all comment files in the archivers
  267.         found?
  268.  
  269.         NO       =  strip comment
  270.    ---------------------------------------------------------------------
  271.         And do you want to add your own comment file to the archives
  272.         that are converted?
  273.  
  274.         NO       =  add comment
  275.    ---------------------------------------------------------------------
  276.         Then, what comment file do you want added?  (leave this line
  277.         out if you want to comment added)
  278.         NOTE: Make sure that the filename is left justified!  No spaces
  279.               should be on the left of the filename!
  280.  
  281.         B:\COMMENT.DAV  =  comment file
  282.    ---------------------------------------------------------------------
  283.         When .EXE self-extracting archives are found, do you want
  284.         them extracted?
  285.  
  286.         NO       =  executables
  287.    ---------------------------------------------------------------------
  288.         If PKZIP 2.0 files are found that have been compressed using
  289.         "normal" compression, do you want them to be re-compressed
  290.         using "EXTRA" compression?
  291.         NOTE: This will immediately change your ARCHIVER to PKZIP 2.0
  292.  
  293.         NO       =  make ZIPs -EX
  294.    ---------------------------------------------------------------------
  295.         Do you want to recurse the subdirectories?  If YES, then all
  296.         directories beneath the current one will be processed also!
  297.  
  298.         NO       =  recurse subdirs
  299.    ---------------------------------------------------------------------
  300.         As a default, STEALTH logs all activity into \STEALTH.LOG.
  301.         This makes it easy to see what happened, and keep track of
  302.         what went where.
  303.  
  304.         yes            =  create log file
  305.         \STEALTH.LOG   =  log file location
  306.    ---------------------------------------------------------------------
  307.         Also as default, STEALTH deletes the old archives, so that
  308.         your hard disk is not cluttered with old and new versions.
  309.         That would make it extremely difficult to sort through them!
  310.  
  311.         yes       =  delete files
  312.    ---------------------------------------------------------------------
  313.         If you want to scan your archives for viruses, you can utilize
  314.         any of the three most popular virus scanners avaiable.  Just
  315.         include the "check for viruses" line, then choose one of the
  316.         scanners listed below (NOTE: You can only specify one)
  317.  
  318.         yes       =  CHECK FOR VIRUSES
  319.  
  320.         VIRUSCAN  =  VIRUS PROGRAM          /* McAfee's */
  321.         F-PROT    =  VIRUS PROGRAM
  322.         TBSCAN    =  VIRUS PROGRAM
  323.    ---------------------------------------------------------------------
  324.         Many PKZIP files have a -AV seal attached to them.  Most people
  325.         (including SYSOPS) may not want to break those sealed files,
  326.         since a "sealed file is a safe file".  If a PKZIP is -AVed, then
  327.         you can be pretty sure no one has tampered with it.
  328.  
  329.         no        =  break PKZIP AV files
  330.    ---------------------------------------------------------------------
  331.         STEALTH has an internal "archive viewer" that allows you to
  332.         see what's inside an archive before/as it is processed.  This
  333.         will allow a clear representation of the file.  Actually,
  334.         the viewer is FASTER than any other I have found.  Try it out!
  335.  
  336.         yes       =  list files before processing
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356. ============  ATTENTION SYSOPS!  ===========================================
  357.  
  358.         STEALTH can save you tons of hard disk space, and serve as a
  359.         processor for uploads.
  360.  
  361.         If some new member uploads you an ancient archive (PAK or ZOO),
  362.         or some unknown self-extracting .EXE archive, how do you
  363.         find out what it is?
  364.  
  365.         It could be a cool game that everybody likes, but the lamer has
  366.         given you a useless file.
  367.  
  368.         STEALTH will instantly recognize the .EXE file as DWC, ZOO, PAK,
  369.         ARJ, PKZIP 1.1, PKZIP 2.0, ARC, LHA, etc.
  370.         Then it will convert it to your BBS's archiver, with no problem.
  371.         Even embedded paths are saved!
  372.  
  373.      **** Included is UPLOAD.CFG configuration for upload processing ****
  374.  
  375.  
  376.         Is your BBS's hard disk getting full?  Run STEALTH as an event
  377.         once a week and convert all of your PKZIP 1.1 and 2.0 "normal"
  378.         compressed files to PKZIP 2.0 "EXTRA" compression!
  379.         That will save MEGABYTES of space (a friend of mine saved over
  380.         2 megabytes on one directory of uploads)
  381.  
  382.      **** Included is EVENT.CFG configuration for event processing ****
  383.  
  384.  
  385.         Plus you can comment all the processed files with your own
  386.         BBS comment file, or simply strip the old comments from
  387.         them.
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396. =========  PLEASE READ THIS!  ===============================================
  397.  
  398.         Please think about what you put into STEALTH.CFG before starting
  399.         the program.
  400.  
  401.   1.    If your "Archiver" and "convert" file types are the same, then
  402.         all files will be processed twice:
  403.  
  404.                 PKZIP2   =   Archiver
  405.                 PKZIP2   =   convert
  406.                 PAK      =   convert
  407.                 ARJ      =   convert
  408.  
  409.         because STEALTH will convert all the .ARJ and .PAK files, then
  410.         convert them again because they are now PKZIP 2.0 files!
  411.  
  412.  
  413.  IMPORTANT NOTE: If you specify MAKE ZIPS -EX, then Stealth assumes
  414.                  you want to use PKZIP 2.0 as your default archiver.
  415.                    It will process files as such!
  416.  
  417.  
  418.   2.    If you have 20 archives with the same name:
  419.  
  420.                 ANOTHER.PAK
  421.                 ANOTHER.ARJ
  422.                 ANOTHER.ZIP
  423.                 ANOTHER.SDN
  424.                 ANOTHER.ZOO
  425.                 ANOTHER.ARC
  426.  
  427.         all of the contents of ALL THE ARCHIVES will be converted into
  428.         your new file.  So, if you said:  PKZIP2  =  Archiver
  429.         then ANOTHER.PAK's contents will be stuffed into ANOTHER.ZIP,
  430.         and ANOTHER.ARJ's contents will be also.  And you will lose
  431.         the original files.  So please don't name several archives
  432.         the same file name, then include all those types in your
  433.         STEALTH.CFG file!
  434.  
  435.   3.    Embedded directories are NOT processed if you use:
  436.  
  437.                   yes  =  recurse subdirs
  438.  
  439.         Why?  Because when you re-compress the file, then you will include
  440.         all subdirectories under the current one.  And if you are in
  441.         the root directory, your whole hard drive will be sucked up into
  442.         the new compressed file!
  443.  
  444.   4.    Please don't STRIP a file's comments, then ADD a comment.  If you
  445.         ADD a comment, then the old one is automatically deleted.
  446.  
  447.   5.    Please make sure ALL FILENAMES IN STEALTH.CFG are left justified!
  448.         For example, your comment file should look like:
  449.  
  450.         ║
  451.         ║C:\PCBOARD\COMMENT.FIL
  452.         ║
  453.                         instead of:
  454.  
  455.         ║
  456.         ║       C:\PCBOARD\COMMENT.FIL
  457.         ║
  458.  
  459.         Because to get the filename, an ASCII 'zero' is placed wherever
  460.         a 'space' character is.  And the filename won't register unless
  461.         it's left justified.
  462.  
  463.  
  464.  
  465.             NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  466.                   format.  Therefore, all 2.0 "stored" archives are
  467.                   flagged as version 1.1.
  468.  
  469.  
  470.  
  471.   7.    Due to the "human" nature of my C++ compiler, if you have
  472.         a THICK layer of subdirectories (more than 10), and each have
  473.         the exact same filenames, one or two files may be skipped.
  474.         This is because the Data Transfer Area of DOS thinks that it
  475.         already processed that file.  This should also be fixed in the
  476.         next version.
  477.  
  478.   8.    Also NOTE: Any unsuccessful de-compression of a file will
  479.         result in the original not being erased.  So if STEALTH does
  480.         not get an errorlevel of 0, then it aborts the erasure process.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493. ===================  WHERE IS DWC?  =========================================
  494.  
  495.      UC2, ARJ, PKZIP, DWC, PAK and all the other archivers can be found at:
  496.  
  497.                  ╔═════════════════════════════════╗
  498.                  ║  Hogard Software Solutions BBS  ║
  499.                  ║      4533 Marblearch Drive      ║
  500.                  ║  Grand Prairie, Tx  75052-4629  ║
  501.                  ║         ASP Member BBS          ║
  502.                  ╟─────────────────────────────────╢
  503.                  ║ (214) 641-6292  up to 38,400bps ║
  504.                  ╟─────────────────────────────────╢
  505.                  ║       SysOp: Chuck Hogard       ║
  506.                  ╚═════════════════════════════════╝
  507.  
  508.         The SysOp is a great guy, and has all of these files available
  509.         for download.  And while you are there, check out the
  510.         Dave's Unique Utilities section.  It has all my stuff, and
  511.         is updated weekly.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525. =============  REGISTRATION  ================================================
  526.  
  527.  
  528.    ┌────────────────────────────────────────────────────────────────┐
  529.    │                                                                │
  530.    │      There ain't no registration.  Stealth is FREE !!!         │
  531.    │                                                                │
  532.    └────────────────────────────────────────────────────────────────┘
  533.  
  534.         NOTE: Also, there is NO TECHNICAL SUPPORT for Stealth.
  535.               If you are having problems with this program, please
  536.               re-read the manual, and make sure nothing is wrong.
  537.               If you still have problems, you may want to try some
  538.               other program OTHER THAN Stealth.
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556. =============  TECHNICAL STUFF  =============================================
  557.  
  558.     Because of the complicated nature of Stealth, problems may arise.
  559.     Here is a list of common difficulties people have written me with:
  560.  
  561.  
  562.       1. Stealth does not process ARJ files properly.
  563.  
  564.     You need at least version 2.39 of ARJ in order to process the switches
  565.     I use.  Of course, the registered Stealth offers customized switches!
  566.  
  567.  
  568.       2. I use STEALTH D:\FILES\*.* and nothing happens.
  569.  
  570.     Of course not.  You must be in the directory with your archivers in
  571.     order to convert them.  If you want to do the above, try:
  572.         D:
  573.         CD\FILES
  574.         STEALTH *.*
  575.  
  576.  
  577.       3. I used Stealth on several PKZIP 2.0 files to make them -EXTRA
  578.          compressed, but nothing happened.
  579.  
  580.     In cases where it could be ANYTHING gone wrong, use the following
  581.     special switch:
  582.  
  583.                 STEALTH *.* /X/+ > LOGIT
  584.  
  585.     This will run Stealth, show technical debugging information that I
  586.     need, and pipe the output into a new file called "LOGIT".
  587.     Now just send the file "LOGIT" to me, along with your STEALTH.LOG,
  588.     and I can sort out what the problem is.
  589.  
  590.     Just upload the files for me at the Hogard Systems BBS, on CompuServe,
  591.     or simply mail them to me at my home address on a disk (any size).
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.